home *** CD-ROM | disk | FTP | other *** search
/ ASP Advantage 1993 / The Association of Shareware Professionals Advantage CD-ROM 1993.iso / files / utilties / listr311 / readme.doc < prev    next >
Text File  |  1993-07-03  |  5KB  |  109 lines
  1. -----------------------------------------------------------------------------
  2. LISTR                         Version 3.11                       Feb 22, 1992
  3. -----------------------------------------------------------------------------
  4. Copyright (c) 1986,87,88,89,90,92                             Brent W. Miller
  5. 565 Ninth Avenue, Menlo Park, CA 94025                  CompuServe 71555,1113
  6. -----------------------------------------------------------------------------
  7.  
  8. Files included with this distribution
  9. -------------------------------------
  10.  
  11. The following files are included in this distribution:
  12.  
  13. README.DOC - This text file
  14.  
  15. DEMO.BAT -  A short demonstration of how LISTR formats a file for printing.
  16.             Type DEMO to run this demonstration.
  17.  
  18. LISTR.EXE - The LISTR executable file
  19.  
  20. LISTR.DOC - The manual for LISTR
  21.  
  22. LISTRCMD.TXT - A sample LISTR command file that might be used for listing
  23.             general text files.  See the LISTR.DOC "COMMAND FILES" section
  24.             for a discussion of how to have this file used by default for any
  25.             file with the .TXT extension.
  26.  
  27. LISTRCMD.C - A sample LISTR command file that would be appropriate for
  28.             listing C programs.  This file includes sample printer setup
  29.             strings that print more characters and lines per page than the
  30.             default 80 column, 66 line mode.
  31.  
  32. NOGR.CMD  - A sample LISTR command file that will strip line graphic
  33.             characters from a file and replace them with standard ASCII
  34.             characters that are printable on all printers, but not as
  35.             esthetically pleasing.  See the instructions below to learn how
  36.             to use this file.
  37.  
  38. REGISTER.DOC - LISTR is shareware.  You are free to try LISTR, and to copy
  39.             it and pass it along to your associates.  It is copyrighted,
  40.             and you are expected to register if you decide you like
  41.             it and plan to use it.  If you plan to use LISTR, please
  42.             print this registration form and use it to register your copy.
  43.  
  44. DESCRIBE.DOC - A file with information intended for shareware distributors
  45.             and BBS operators.  Includes one line, short and long
  46.             descriptions of LISTR for inclusion in catalogs.  Also includes
  47.             author information.
  48.  
  49. LISTR.DEM - A short text file used by DEMO.BAT to demonstrate LISTR.
  50.  
  51. LISTRCMD.DEM - Formatting commands used by LISTR in DEMO.BAT
  52.  
  53. Removing line graphic characters from LISTR.DOC
  54. -----------------------------------------------
  55. LISTR.DOC makes use of the extended character set that is available on PC's
  56. and clones.  Most, but not all, printers support this extension to the ASCII
  57. character set.  If you see strange characters where lines and boxes should
  58. appear, your printer probably does not support these characters.
  59.  
  60. LISTR can be used (with the NOGR.CMD command file) to replace the graphic
  61. characters with printable characters.  This is a good example of one use for
  62. LISTR.  Look at NOGR.CMD on any editor to see how it works.  To prepare a
  63. version of LISTR.DOC without graphics, use the following command:
  64.  
  65.      LISTR LISTR.DOC NOGR.CMD LISTR.TXT
  66.  
  67. This command assumes that you have copied all the files from the
  68. distribution disk to your working directory.  When LISTR finishes, the file
  69. LISTR.TXT will be a copy of LISTR.DOC, with the appropriate substitutions
  70. made.
  71.  
  72. Note that certain of the examples in LISTR.DOC use the line graphic
  73. characters.  You will have to use your imagination a bit to understand these
  74. examples after removing graphic characters.
  75.  
  76. New in this version
  77. -------------------
  78. Version 3.11 added the EJECT ON|OFF command.  With EJECT OFF, the form
  79. feed or line feeds to eject the last page of a listing is suppressed.
  80. The default operation is identical to previous versions.
  81.  
  82. A file safety feature has also been added.  In previous versions, it was
  83. possible to specify the same file as the input (or command) file and the
  84. output file.  The result was to overwrite the input file.  LISTR now checks
  85. for the same file being specified as input and output and aborts without
  86. harm.  Note, however, that NO CHECK IS MADE FOR THE EXISTENCE OF THE OUTPUT
  87. FILE if it is not the same as one of the input files.  It is possible to
  88. overwrite an existing file.  This is the same as with many DOS commands
  89. (e.g., COPY).  In many cases, it is desirable to write to a temporary file,
  90. and then print that file using the DOS print spooler or another spooler.  If
  91. you use the same temporary file over and over, it is convenient to allow
  92. overwriting.  Be careful to specify the correct output file.  If you forget
  93. the file name order on the command line, just type LISTR for a short
  94. description of the parameters used with LISTR.
  95.  
  96. B. Miller  7/06/92
  97. ============================================================================
  98.               _______
  99.          ____|__     |               (R)
  100.       --|       |    |-------------------
  101.         |   ____|__  |  Association of
  102.         |  |       |_|  Shareware
  103.         |__|   o   |    Professionals
  104.       -----|   |   |---------------------
  105.            |___|___|    MEMBER
  106.  
  107. ============================================================================
  108. 
  109.